home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 22 Graphics & Utilities / HR2RLE.DOC < prev    next >
Encoding:
Text File  |  2019-04-13  |  3.5 KB  |  71 lines
  1.  
  2.         HR2RLE
  3.  HiRes to Run Length Encoder
  4.   For the Commodore 64
  5.    (c) 1985 by Chrisdos.
  6.     All rights reserved.
  7.         Ver 1.0
  8.  
  9.  
  10. The HR2RLE program will allow you to convert almost any HiRes image to
  11. a RLE format file that can be uploaded online, and can be read back by
  12. any computer that can translate the RLE data.
  13.  HR2RLE will convert the area of memory starting at $6000 and extending for
  14. 8000 bytes to RLE data and save it to disk. This is compatable with DOODLE
  15. and other programs that store their HiRes bitmaps at $6000.
  16.  
  17.         Usage
  18.         -----
  19.  Simply LOAD"HR2RLE",8 and run.
  20.         You will be prompted for the exact filename of the picture to convert.
  21.         Then you will be asked for the filename for the output. HR2RLE will add
  22.  ".RLE" to the filename so you know it is in a RLE Format.
  23.         You will then be prompted for <RETURN to TEXT>. If you enter "y" then 
  24. HR2RLE will add the code that tells the RLE decoding program to return to
  25. TEXT mode to the end of the file. Entering any other key means No.
  26.         Next question is X Offset. Since the C64 screen is 320 pixels wide,
  27. and the RLE file can only handle 256, there is a 64 pixel gap. You can tell
  28. HR2RLE on what pixel column to start the conversion. 0 is the first column.
  29. 32 would be the 256 pixels in the center of the screen. 63 would be the
  30. 256 of the right most pixels.
  31.         You can then do the same for the Y Offset. The screen is 200 pixels
  32. long, but RLE can only do 192 of them. Y = 0 is the top 192 rows, Y = 7 is the
  33. bottom 192 rows. (in other words, skip the first 7.)
  34.         The last question is Normal or Inverse. This means you can create an
  35. RLE file with white and black reversed if you enter an "i". Any other key
  36. means normal.
  37.  
  38.         The screen will goto HiRes and the picture file you gave will load.
  39.         HR2RLE will then read the picture from the scree and write the RLE
  40. file. As it does it, the area it is working on will reverse image.
  41.         If there is a DISK ERROR, (picture file not found, bad file name, drive 
  42. not ready, etc.) HR2RLE will hang, Hit Run/Stop/Restore to exit.
  43.  
  44.         The file will be written to disk, and when finished, you will return
  45. to normal text screen.
  46.         The RLE file may then be uploaded for use online.
  47.  
  48. NOTE: The option to selectively add the <RETURN to TEXT> signal at the end
  49. of the RLE file is there because of the way RLE Decoding programs operate.
  50. When you view a RLE file from a CIS source (CB pictures, weather maps, etc.)
  51. a <GOTO HIRES> signal is sent to you, then the RLE data. At the end, CIS waits
  52. for you to send a <RETURN> then cis sends a <RETURN TO TEXT> signal that
  53. resets your terminal program to text mode. If you did not get the <RETURN TO
  54. TEXT> then your terminal program might be hung in graphics mode.
  55.         The problem with creating your own RLE file is that there is no eazy
  56. way to hold off that <RETURN to TEXT> signal at the end of the file since
  57. it is only a character in the file. About the only way to hold off the <R2T>
  58. is to send a Control-S at the very last line of the file. You may then
  59. process or look at the image on your screen. When you are ready to continue
  60. you may send a Control-Q to resume transmition. The <R2T> characters will be
  61. send and your terminal reset to normal.
  62.  Unless you have a special need to not have the <R2T> characters, the add it.
  63.  If you upload a file that does not have it, make sure to say so in the
  64. description.
  65.  
  66.  
  67.         The RLE files should be uploaded in 7 bit ASCII mode so that they may
  68. be directly READ from a Data Library.
  69.  
  70. This file and the program are (c) 1985 by Chrisdos. All rights reserved.
  71.